home *** CD-ROM | disk | FTP | other *** search
/ Deutsche Edition 1 / Deutsche Edition 1.iso / amok / amok_lha / amok33.lha / FInOut / FInOut.dok < prev    next >
Text File  |  1993-08-15  |  3KB  |  94 lines
  1. ======================================================================
  2. Dokumentation zu "FInOut" Version 1.0
  3. Autor: Michael Frieß / Mühlhaldenweg 16 / 7035 Waldenbuch
  4. ======================================================================
  5.  
  6. Übersicht
  7. ­­­­­­­­­
  8. * Kopierrecht
  9. * Umfang des Projekts
  10. * Einleitung
  11. * Beschreibung der Prozeduren
  12. * Demo- / Testprogramm
  13.  
  14.  
  15. Kopierrecht
  16. ­­­­­­­­­­­
  17. Das komplette Projekt (Quelltext, Dokumentation und Objectcode) ist
  18. Public Domain Software. Es darf beliebig kopiert und verbreitet werden
  19. solange...
  20.  
  21. * mein Name und dieser Kopierrechtshinweis erhalten bleiben,
  22. * die Vollständigkeit des ganzen Projekts gewährleistet ist, und
  23. * mit dem Vertrieb dieser Software kein Gewinn erwirtschaftet wird.
  24.  
  25. Die Kommerzielle Nutzung ohne meine ausdrückliche schriftliche
  26. Genehmigung ist untersagt.
  27.  
  28. Verbesserungsvorschläge sind stets willkommen. Falls Sie Veränderungen
  29. am Programm vornehmen, dokumentieren Sie diese bitte gut verständlich.
  30. Es würde mich freuen, wenn Sie mich über größere Veränderungen oder
  31. Erweiterungen in Kenntnis setzen würden, so daß diese über eine neue
  32. AMOK-Diskette verbreitet werden können.
  33.  
  34. (c) 1990 by Michael Frieß.
  35.  
  36.  
  37. Umfang des Projekts
  38. ­­­­­­­­­­­­­­­­­­­
  39. Das komplette Projekt "FInOut" beinhaltet folgende Dateien:
  40.  
  41. * FInOut.dok   Diese Dokumentation
  42. * FInOut.def   Quelltext der Definition
  43. * FInOut.mod   Quelltext der Implementation
  44. * TestFInOut.mod Quelltext des Testprogramms
  45. * TestFInOut   Testprogramm
  46.  
  47. (Stand 08.02.1990)
  48.  
  49.  
  50. Beschreibung
  51. ­­­­­­­­­­­­
  52.  
  53. Sowohl das FileSystem Modul, das beim M2Amiga mitgeliefert wird, als
  54. auch die AmigaDOS Funktionen sind auf einer sehr niedrigen Ebene
  55. angelegt. Es kann also alles damit gemacht werden, nur eventuell sehr
  56. umständlich. Die Idee dieses Moduls ist die einfache Schnittstelle des
  57. InOut Moduls auf Dateioperationen zu übertragen, so daß auf ähnliche
  58. Weise auch auf Dateien zugegriffen werden kann.
  59.  
  60. Dabei werden zusätzlich zu den InOut kompatiblen Funktionen noch ein
  61. paar weitere angeboten (Komfort!).
  62.  
  63. Syntax und Semantik der Funktionen ist dem Definitionsmodul zu
  64. entnehmen. Als Beispielanwendung kann das Testprogramm zu Rate gezogen
  65. werden.
  66.  
  67. Funktionsweise
  68. ­­­­­­­­­­­­­­
  69.  
  70.  Es wird für jede Datei ein doppelter Puffer verwendet. Die
  71.  Dateizugriffe erfolgen nur, um einen der beiden Puffer neu einzulesen
  72.  oder abzuspeichern. Die Funktionen hantieren vor allem auf den
  73.  Puffern, somit wird also der Dateizugriff minimiert.
  74.  
  75.  Es werden intern die AmigaDOS Funktionen für den Dateizugriff verwendet.
  76.  
  77. Einschränkungen
  78. ­­­­­­­­­­­­­­­
  79.  Das gleichzeitige Schreiben und Lesen wird momentan nicht
  80.  unterstützt, da ich mir über die damit verbundenen Probleme keine
  81.  Gedanken gemacht habe.
  82.  
  83.  Das Zurückgeben von Zeichen beim Einlesen wird nicht unterstützt.
  84.  Dies ist vor allem beim Scannen von Dateien wichtig, wenn Zeichen
  85.  "voraus" gelesen werden und dann eventuell wieder zurückgegeben
  86.  werden.
  87.  
  88. Testprogramm
  89. ­­­­­­­­­­­­
  90. Das Testprogramm demonstriert das Schreiben auf Datei mit den
  91. unterschiedlichsten Funktionen. Als Datei wird "RAM:Test.Dat"
  92. beschrieben. Danach wird das Lesen aus eben derselben Datei getestet.
  93.  
  94.